home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1996 April / MacFormat CD Edition MF36 (April 1996).iso / Shareware City / Developers / Tools Plus - GUI⁄Event libs / Tools Plus 2.6.1a Evaluat'n Kit / Tools Plus 2.6.1a / User Manual / Update History / Read Me! 2.0 -> 2.1 changes next >
Text File  |  1994-09-11  |  5KB  |  111 lines
  1. Tools Plus Changes: 2.0 to 2.1
  2. ~~~~~~~~~~~~~~~~~~~~~~~
  3. Display this document in Geneva 12pt.
  4.  
  5. You need to read this document if:
  6.    √ You are upgrading from Tools Plus version 2.0.
  7.  
  8. Tools Plus 2.1, released in November 1993, includes the following revisions from the previous version of Tools Plus (2.0).
  9.   • Tools Plus is now available for THINK C and THINK Pascal
  10.   • Tools Plus is compatible across all systems (System 5 or higher)
  11.   • Some minor revisions were made, primarily to ensure
  12.      compatibility between C and Pascal.
  13.   • Minor revisions were made in the User Manual
  14.   • Tools Plus now has 100% consistency with applications compiled
  15.      for plain 68000 processors, optimized for 68020, 68030 or
  16.      68040 processors, and/or optimized for a math co-processor.
  17.  
  18.  
  19.  
  20. Compatibility with THINK C
  21. ~~~~~~~~~~~~~~~~~~~~~~
  22. Tools Plus is now available in two languages: “Tools Plus for THINK C” and “Tools Plus for THINK Pascal.”  In Pascal, the SystemVersion routine was changed (details provided later) to ensure compatibility between C and Pascal.
  23.  
  24.  
  25.  
  26. System 6 Fix:
  27. ~~~~~~~~~~
  28. Tools Plus 2.0 (Pascal) running on System 6.0.x (only on Macs with certain hardware configurations) would sometimes get bus errors.  This has been corrected in v2.1.
  29.  
  30.  
  31.  
  32. System Compatibility:
  33. ~~~~~~~~~~~~~~~~~
  34. Tools Plus 2.1 performs seamlessly on Macintoshes running…
  35.     √ System 5 (Finder or MultiFinder)
  36.     √ System 6 (Finder or MultiFinder)
  37.     √ System 7
  38.  
  39.  
  40.  
  41. Command-Key Fix:
  42. ~~~~~~~~~~~~~~
  43. In v2.0, if an application had no menus and a Command-Key was typed, a bus error would occur.  This has been corrected in v2.1.
  44.  
  45.  
  46.  
  47. High-Level Event Fix:
  48. ~~~~~~~~~~~~~~~~
  49. System 7’s incoming high-level events were not reported in v2.0.  This has been corrected in v2.1, where high-level events are reported as part of Tools Plus’s “doManualEvent” event.
  50.  
  51.  
  52.  
  53. Installation Instructions changed:
  54. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  55. Within a THINK Pascal project, users are instructed to place the ToolsPlus.p interface file in the same segment as the ToolsPlus.Lib2 library (see “Installing Tools Plus in THINK Pascal” in the User Manual for details).
  56.  
  57.  
  58.  
  59. doClickControl event change:
  60. ~~~~~~~~~~~~~~~~~~~~~~~
  61. When receiving a Tools Plus “doClickControl” event, the polling record’s “Modifiers” field is now populated to simplify detection of Modifier keys.
  62.  
  63.  
  64.  
  65. SystemVersion routine changed:
  66. ~~~~~~~~~~~~~~~~~~~~~~~~~
  67. In v2.0, SystemVersion returned the System file’s version as a “real” precision number.
  68.    SystemVersion now returns an “extended” precision number in Pascal, and a “double” precision number in C (see the User Manual for details).
  69.  
  70.  
  71.  
  72. MenuMark documentation changed:
  73. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  74. The User Manual has been revised to better describe the “MenuMark” routine, and several new constants have been defined to make programming simpler (see the User Manual for details).
  75.  
  76.  
  77.  
  78. CursorShape documentation changed:
  79. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  80. The User Manual has been revised to better describe the “CursorShape” routine (see the User Manual for details).  Specifically, the manual now describes in more detail how to take advantage of Tools Plus’s automatic cursor changes.
  81.  
  82.  
  83.  
  84. doKeyDown, doAutoKey and doKeyUp event documentation changed:
  85. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  86. Tools Plus’s “doKeyDown,” “doAutoKey” and “doKeyUp” events inform an application of keystroke-related events.  These sections in the User Manual now detail the detection of function keys (F1 through F15 on an extended keyboard), and provide more details regarding the “escape” and “clear” keys.
  87.  
  88.  
  89.  
  90. User Manual change:
  91. ~~~~~~~~~~~~~~~~
  92. System 7’s osEvt (operating system event) constant has the same value as System 6’s (and prior) app4Evt event.  The User Manual now explicitly includes the osEvt constant for consistency with other System 7 documentation.
  93.  
  94.  
  95.  
  96. Compiler Options:
  97. ~~~~~~~~~~~~~~
  98. With Tools Plus 2.1, you can use the same libraries and support files regardless if you are compiling your application for a plain 68000 processor, or optimizing it for 68020, 68030, or 68040 processors, and/or optimizing it for a math co-processor (68881, 68882 or 68040.)
  99.  
  100.  
  101.  
  102. Arrays in C versus Pascal:
  103. ~~~~~~~~~~~~~~~~~~~~
  104. Tools Plus’s polling record contains a pair of 3-element arrays.  As defined in Pascal, the elements are numbered 1, 2 and 3.  In C, the same array’s elements are numbered 0, 1 and 2 (they start at zero).
  105.    Please keep this in minds when reading chapter 12 of the Tools Plus User Manual (System Polling).  When C programmers read:
  106.          Poll.Mouse.Down[1].Where
  107. it indicates the first element of the array, which translates to the following C source code:
  108.          Poll.Mouse.Down[0].Where
  109.  
  110. Affected pages is the User Manual are: 101, 118 and 119.
  111.